home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / dev / basic / gtboxconv.lha / gtboxconv / docs / english / GtBoxConv.DOC < prev    next >
Text File  |  1995-10-24  |  8KB  |  202 lines
  1. ----------------------------------------------------
  2. GadToolsBox Converter V3 - Written By Fabio Rotondo.
  3. ----------------------------------------------------
  4.  
  5. WARNING:
  6. --------
  7. This  software  is  provided "as is", the author cannot be found guilty for any
  8. hardware/software  damage,  os anomalyes deriving from using this program.  Use
  9. this program at your own risk.
  10.  
  11. COPYRIGHT:
  12. ----------
  13. This program is (C)Copyright 1995 Fabio Rotondo.
  14. Even  if  the  program is copyrighted, you can freely use and redristribuite it
  15. without asking any money for the sharing.
  16. This program is GiftWare, that means if you use it, you should send me a "gift"
  17. of any kind (disks, money, software you made, postcards ...)
  18.  
  19.   Sed your gift and comments to
  20.     Fabio Rotondo
  21.     C.so Vercelli 9
  22.     28100 Novara
  23.     Tel 0321 - 459676
  24.  
  25.   You can find contact me also at:
  26.  
  27.   fsoft@intercom.it
  28.  
  29. I hope you will enjoy my work and will use my program.
  30.  
  31. SHARING:
  32. --------
  33. This program is freely distribuible.  So you can copy and install it on your HD
  34. without  breaking  any  law.  For the sharing, anyway, you have to follow these
  35. rules:
  36.  
  37.   1 - Do not modify in any way the ".lha" archive the program is shared in.
  38.   2 - Do not add, delete or modify any file inside the archive.
  39.   3 - In case you would translate the program or docs in other languages,
  40.       you have to obtain written permission from the author.
  41.   4 - In case you would insert the program in a compilation of free/shareware
  42.       programs to be sold, you have to obtain written permission from the
  43.       author. I would appreciate receiving also a copy of this compilation.
  44.   5 - If you use these program to create a PD or Commercial software I would
  45.       appreciate being mentioned inside Greetings and, if possible, receive
  46.       a copy of the program.
  47.   6 - This program is GiftWare: send me something...
  48.  
  49. If you follow these conditions, then we will friends forever.
  50.  
  51. -->> SORRY FOR MY BAD ENGLISH !!! <<--  :)
  52.  
  53. INTRODUCTION:
  54. --------------
  55. GadTools  Converter  V3  is  a  program  which allow you to convert GadToolsBox
  56. created interfaces into BlitzII code.
  57. Its  use is very simple and immediate.  If you know how GadToolsBox works, then
  58. you can also use GadToolsBox Converter (from now on, simply GTConv).
  59. This  program  was born as a little personal-use software for convertion and it
  60. evolves  to  what  you now have inside your own hands:  V3.  A lots of modifies
  61. applied  to  the  original  software  and  a lot will change in future releases
  62. (assuming new releases will be done...  ;)
  63. Initially,  when  they  implemented gadtools.library into BlitzII, there was no
  64. way  to  write pretty good interfaces, then I begun playing with GadToolsBox by
  65. Jaba  Developement  and understood that with a bit of work, I should be able to
  66. create a converter from GadToolsBox to BlitzII.
  67. And here it is :)
  68.  
  69. The most important things of the new version V3 you have are:
  70.   - You can select max number of BevelBoxes, Texts and Menus.
  71.   - You can select GTList and WindowNumber to generate.
  72.   - Self memory allocation for gadget creations.
  73.   - Using of CONSTANTS defined inside GTBox for gadget numeration.
  74.     (This simplify and enhance code creation. :)
  75.   - New and more efficent version of gadgets handler  which could be created
  76.     automatically by GTConv (see below)
  77.   - New system of cretion of windows: now requesters ReqTools ALWAYS open on
  78.     the correct window.
  79.   - Better GTBox parsing of C code.
  80.   - Enhanced and better working looping routine.
  81.  
  82. NOTE: this is the first real PD release of this program. Other versions were
  83.       always given only to "close friends". I hope this will encourage its
  84.       using and could help me getting GTConv always better.
  85.  
  86.  
  87. INSTRUCTIONS:
  88. -------------
  89. Being  a  converter,  GTConv  needs  some  code to conv.  At the moment, GTConv
  90. converts  into  BlitzII  code  C  version  of GTBox generated code.  So, to use
  91. GTConv  you  have  to  have GTBox (but who has not?  :) and let it generate a C
  92. source pressing Amiga-C or choosing "Generate C Source" from the menu.
  93.  
  94. NOTE 1: GTConv reads many times the same code generated by GTBox, so it is
  95.         better to save the source C code into Ram Disk. This speeds up
  96.         convertion a lot.
  97.  
  98. NOTE 2: GTConv needs in the same directory both ".c" and ".h" code. This
  99.         should be no problem, considering the fact that GTBox creates these
  100.         two files into the same dir, but PAY ATTENTION NOT TO DELETE ".H"
  101.         FILE! Otherwise, GTConv won't generate good code.
  102.  
  103. NOTE 3: Even if GTBox allows to edit a lot of windows at the same time, this
  104.         is not possible using GTConv. You have to generate a different C
  105.         source for every window you want to create.
  106.  
  107. If you have a C source generated by GTBox, you have almost end all your work.
  108.  
  109. GTConv window could be ideally split into three zones:
  110.   1 - "Actions" zone
  111.   2 - "Settings " zone
  112.   3 - "Advanced Settings" zone
  113.  
  114. ACTIONS:
  115. -------
  116. Possible operations in "Actions" zone are:
  117.  
  118. CONVERT: this is the main operation. It will open a file requester and asks
  119.          for a C source GTBox generated to start the convertion. At the end
  120.          of the convertion a new requester will pop up asking for a
  121.          DESTINATION file name, where GTConv will write its own code for
  122.          BlitzII.
  123. ABOUT:   it writes a (C)Copyright message.
  124. QUIT:    exits from GTConv.
  125.  
  126. SETTINGS:
  127. ---------
  128. This  zone has Check Boxes and Integer Gads, checking CheckBoxes will influence
  129. code generated by GTConv.  Here there is a brief documentation of them.  Values
  130. between parentesys are defaults.
  131.  
  132. Add GadHandler (CHECK): (OFF)
  133.   if selected, it adds a short routine to handle gads. It is useful to
  134.   start quickly your own program generation.
  135.  
  136. Add Comments (CHECK): (OFF)
  137.   if selected, it adds a few comments to BlitzII code to help novice
  138.   programmers to understand the code better.
  139.  
  140. Show Operations (CHECK): (ON)
  141.   if selected, GTConv shows in the "operations" zone some messages about
  142.   current operation.
  143.  
  144. Generate Gads & Bevels Only: (OFF)
  145.   if selected, only gadget and bevel box code will be created without
  146.   generating nothing more. It is useful in case you have modified gads
  147.   interface, but window and screen were left untouched.
  148.  
  149. GTList  Number (INT): (0)
  150.   this gad contains the GTList value used to generate code.
  151.  
  152. Window Number (INT): (0)
  153.   same as GTList Number for the window.
  154.  
  155. ADVANCED SETTINGS:
  156. ------------------
  157. Modify these setting sin case you will need more Bevels, texts or Menus.  These
  158. gads  contain  the  default  values.   Usually,  you won't need to change these
  159. values, anyway.
  160.  
  161. CONCLUSIONS:
  162. ------------
  163. I  hope  GTConv will be useful and you will use it as often as you can.  If any
  164. "bug"  or  anomaly  in  conversion would occur, please contact me and send me a
  165. copy of teh ".gui" file, so I will fix the bug.
  166.  
  167. THANKS AND GREETINGS:
  168. ---------------------
  169. I would like to thank the following people for their creations:
  170.  
  171.    Nico Francois : For his great "reqtools.library"
  172.    Neil O'Rurke  : For his BlitzII ReqTools implementation.
  173.   Commodore Amiga: For "gadtools.library" and the BEST COMPUTER EVER. :)
  174. Jan van der Baard: For creating GadToolsBox. A WONDERFUL program.
  175.  
  176. I would like to greet these:
  177.  
  178.   Michele Puccini (ClassX) : for appreciate my programs and warning me
  179.                              about GTConv bugs. (And also for all his
  180.                              programming tricks... :)
  181.   Kronos The Wizard : for giving me always a wonderful time when I write code
  182.                       with him.
  183.   Stefano Clemente : for always encouraging me in my programs creations.
  184.   Commando Unlimited: for his great graphic and for not minding at all about
  185.                       my not-game programs.
  186.   Fabio Milos: forloving my Quadranoid!
  187.  
  188. AUTHOR:
  189. -------
  190. GTConv has been written by:  Fabio Rotondo.
  191.  
  192. The author can be contacted in this way:
  193.  
  194. FABIO ROTONDO
  195. C.so Vercelli 9
  196. 28100 Novara
  197. ITALY
  198. Tel. 0321 - 459676
  199.  
  200. E-Mail: fsoft@intercom.it
  201.  
  202.